Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / sdl.arc / SD.DOC < prev next >

Wrap

Text File | 1986-05-31 | 54.6 KB | 1,651 lines

S A F E D E P O S I T (tm) PC to PC File Exchange System Version 1.1, June 2, 1986 Easy, Fast, Reliable and Foolproof RS-232C file exchange software for the IBM-PC and compatibles. Level-0 Disk Based Documentation This document contains all information needed to use the Safe Deposit Level 0 System. Level 0 is distributed as a shareware product. This entire diskette (or archive file) may be freely copied and distributed subject to the conditions outlined in chapter 1. An individual may use this software on a trial basis at no charge. Frequent users are encouraged to register their copies of Safe Deposit by remitting a nominal fee, or, to purchase a copy of and license to use Safe Deposit Level 1, an enhanced version. PLEASE COPY AND DISTRIBUTE THIS SOFTWARE Copyright (C) 1986 The Jay Gee Programming Company 7185 Blue Hill Drive San Jose, CA 95129 (408) 257-7795 CompuServe 72345,130 John Golini, President Table of Contents Chapter Description Page 1 Shareware License and Agreement......3 2 Level 0 Overview.....................7 3 SDSERVE Operator's Manual...........10 4 SDCALL Operator's Manual............16 5 Level 1 Overview....................24 During on-line review, search for "-N-" to locate the top of chapter N. June 2, 1986 2 Safe Deposit Level 0 Chapter -1- Shareware License and Agreement THE LICENSE Safe Deposit Level 0 is copyrighted. Even though the program is shareware, and can be freely copied, there are still some limitations to protect the quality of the distribution of the program and to support future development. Users of Safe Deposit Level 0 may make unmodified copies of these programs for trial use by others on a PRIVATE NON-COMMERCIAL BASIS. By accepting and using this software, the user acknowledges that this software may not suit his particular requirements or be completely trouble-free. With proper application, this software will perform as described. However, The Jay Gee Programming Company is not responsible for your specific application or any problems resulting from use of this software. If the software does not perform as described, our liability to you is limited to replacing the software or refunding the registration fee (if registered). We have no liability to any person or entity for any damage or loss, including special, incidental, or consequential damages, caused by this software, directly or indirectly. Some states do not allow the limitation or exclusion of liability for incidental or consequential damages, so the above limitation or exclusion may not apply. This agreement is governed by the laws of the State of California. Should any part of this Agreement be held invalid, the remainder of the Agreement will still be in effect. This Agreement can only be modified by written statement signed by an authorized representative of The Jay Gee Programming Company. PERMISSIONS AND RESTRICTIONS Under this license, an individual MAY: 1) Distribute copies of the entire program diskette (or all files contained therein), intact and unmodified, for trial use by others on a PRIVATE NON-COMMERCIAL BASIS. Diskette copies must bear a facsimile of the paper label on the June 2, 1986 3 Safe Deposit Level 0 original diskette which includes the program name, version and copyright notice. The following text must appear on the label: Safe Deposit Level 0 (tm), Version 1.1, 6/2/86 Copyright (C) 1986, The Jay Gee Programming Company All Rights Reserved 2) Up-load an image of the entire diskette (or all files contained therein) to an electronic bulletin board or information service for subsequent down-load by other trial users. Under this license, an individual MAY NOT: 1) Distribute the program in connection with any other product or service, or as part of a corporate or institutionally sponsored distribution. Site licenses and bundling agreements are available upon request. 2) Charge anything for Safe Deposit Level 0. An exception is made for registered user groups who may charge a cost-based fee (not to exceed $5) to cover their own costs. 3) Distribute the program in modified form. HOW TO REGISTER To become a registered user just fill out the registration form on the next page and mail it with a check or money order for $15 to The Jay Gee Programming Company at the address shown on the form. Please do not send cash or credit card numbers. WHAT YOU GET FOR YOUR REGISTRATION FEE 1) A typeset copy of this manual, including all recent updates and additions. 2) The most recent version of the programs. 3) Automatic notice of updates which are available at media and postage costs of about $3, or at no charge when down-loaded by you from our on-line Safe Deposit Server. 4) Hotline telephone support during normal business hours. 5) Electronic on-line support via EasyPlex on CompuServe. 6) The knowledge and satisfaction that you are supporting the shareware concept that allowed you to receive Safe Deposit in the first place. Only through your support can we June 2, 1986 4 Safe Deposit Level 0 continue to improve Safe Deposit and perhaps develop other products. GUIDELINES FOR WHEN YOU SHOULD REGISTER If you make daily use of either of the two Safe Deposit commands (SDSERVE or SDCALL) then you are obligated to register your copy of Safe Deposit Level 0. What's more, you will probably benefit greatly by purchasing a copy of and license to use Safe Deposit Level 1. Level 1 provides many additional features and enhancements above Level 0. If you find yourself running either of the two Safe Deposit commands (SDSERVE or SDCALL) more than once per week on a regular basis, then you probably ought to become a registered user. If you use Safe Deposit less than once per week then you can remain a "trial" user without having a bad conscience. If, however, you find that you are vitally dependent on Safe Deposit even at a low frequency of use you should become a registered user to insure support and continued availability of the product. June 2, 1986 5 Safe Deposit Level 0 SAFE DEPOSIT (tm) LEVEL 0 REGISTRATION FORM Please fill in the blanks below and mail this page with your check or money order for $15.00 to: The Jay Gee Programming Company 7185 Blue Hill Drive San Jose, CA 95129 You will receive your registration packet in the mail in 2 to 3 weeks. Please do not send cash or credit card numbers. Dear Jay Gee: Please register my copy of Safe Deposit Level 0. I agree to abide by the license agreement outlined in the disk-based document which I received with my copy of Safe Deposit. Name:____________________________________________________________ Company:_________________________________________________________ Address:_________________________________________________________ City:___________________________ State:________ Zip:_____________ Telephone:_______________________________________________________ Signed:______________________________________ Date:______________ How I first learned about Safe Deposit or where I first obtained a copy of it: _________________________________________________________________ _________________________________________________________________ _________________________________________________________________ The PC configuration on which I run Safe Deposit: Manufacturer and Model:__________________________________________ Amount of RAM:____________ Number of Serial Ports:___________ Number, Type & Capacity of Disks:________________________________ Co-resident Software:____________________________________________ June 2, 1986 6 Safe Deposit Level 0 Chapter -2- Level 0 Overview INTRODUCTION Safe Deposit is an easy, fast, reliable, and foolproof way to copy files, of any type and size between two IBM-PCs or compatibles (running PC-DOS or MS-DOS) using an RS-232C serial port connection. The two computers may be connected by modems, over phone lines or directly, through a null modem. FEATURES - Unattended server operation. - Changeable baud rate. - Robust proprietary data transfer protocol using CRC-16 error detection technique. Detects and recovers from all possible types of transmission errors including most "call waiting" interruptions and indiscriminate manual interruptions (limited by type of modem used). - Can be run under DoubleDOS [1] or Topview [2] as a background process. - Supports modem control signals. - Rudimentary support for intelligent modems such as Hayes Smartmodem. - Each caller has his own ID and private subdirectory of files. - Caller is restricted to his own subdirectory. - Runs on the Data General/One. ____________________ [1] DoubleDOS is a trademark of SoftLogic Solutions, Inc. [2] Topview is a trademark of IBM Corp. June 2, 1986 7 Safe Deposit Level 0 SYSTEM REQUIREMENTS - IBM-PC/XT/AT/JR [3] or compatible. - One serial port RS-232C device. - 48K of RAM, not including DOS and any other resident software. - PC-DOS or MS-DOS 2.0 or higher. OPERATION One of the PCs is designated as the "server" and runs a program called SDSERVE. SDSERVE runs completely unattended. It monitors the communication port for the connection of a "caller" PC (running SDCALL). The first thing that happens after a connection is established is that the caller's operator must enter an "access code". The access code corresponds with one single subdirectory name on the server system. The subdirectory must already exist for the caller's access rights to be granted. Once the caller has logged-in with a valid access code all file operations are limited to this subdirectory. The caller's subdirectory must be present in the current drive and subdirectory in which SDSERVE was started. The server PC's operator can easily control who has access to his system by simply creating or removing subdirectories. A caller cannot access any files or information on the server other than those in his own subdirectory. A simple menu is then presented to the caller: <F1> List Directory <F2> Delete File(s) <F3> Send a File <F4> Get a File <F5> View a File <F6> Terminate Session List Directory produces a display on the caller's system of all of the files present in his subdirectory on the server. The display format is similar to the long format of the "dir" command under DOS. Delete File(s) allows the caller to remove one or more files from his subdirectory on the server. He is asked to provide one file name optionally containing wildcard characters. ____________________ [3] IBM-PC is a trademark of IBM Corp. June 2, 1986 8 Safe Deposit Level 0 Send a File is used to copy a file from the caller's system to the server. The caller is asked to provide one file name which identifies the file to be copied. It may contain drive and path designators. The file is copied to the server and is placed in a file of the same name (without the caller's drive and path) in the caller's subdirectory on the server. Any file of the same name already present is automatically overwritten. Get a File copies a file from the caller's subdirectory on the server to the caller's own system. The caller is asked to provide one file name identifying the file to be retrieved. The file is placed on the caller's system in the current drive and subdirectory with the same file name. Any file of the same name already present is automatically overwritten. View a File is similar to Get a File except that the file is displayed on the caller's screen and is not placed on his disk. This is similar to the "type" command under DOS. It is only appropriate for text files. Terminate Session breaks the communication connection and returns the caller to DOS. The server the proceeds to wait for the next connection to be established and allows the same or a different caller to log-in. A 4-second break in the communication line results in automatic termination of the session. June 2, 1986 9 Safe Deposit Level 0 Chapter -3- SDSERVE Operator's Manual INTRODUCTION This chapter outlines the recommended procedure for setting-up and running the Safe Deposit Level 0 server on your system. Knowledgeable DOS users may tailor this procedure to fit their own needs. Please read the overview description of Safe Deposit in Chapter 2 before proceeding. This manual assumes a casual working knowledge of DOS. WHAT IS SDSERVE? SDSERVE is the command that you use to start the Safe Deposit file server on your system. The file server allows one caller at a time to connect through your serial port or modem and work with files in his own private subdirectory. SETTING UP ACCESS TO YOUR SYSTEM Your callers' subdirectories must all reside on one disk volume that will be resident when SDSERVE is running. You place them all in a higher-level subdirectory, "SAFESERV", which is created in the root directory of the selected disk volume. Perform the following steps to set up your system. The following examples assume that you are using drive C. 1) Create a subdirectory named "SAFESERV" in the root directory using the following commands: c: cd \ md safeserv 2) Insert the Safe Deposit Level 0 distribution diskette into a floppy drive (drive A is assumed below) and use the following commands to copy the needed programs: copy a:sdserve.exe copy a:move.com copy a:X serve.bat For "X" substitute: nserve.bat for direct connection by null modem or for use of a simple modem. iserve.bat for use of a non-Hayes compatible intelligent modem. June 2, 1986 10 Safe Deposit Level 0 hserve.bat for use of a Hayes (300 or 1200)- compatible modem with switch #6 UP ("REAL DCD"). See the discussion of modem switch settings in the section below entitled "STARTING THE SERVER". hwserve.bat for use of a Hayes (300 or 1200)- compatible modem with switch #6 DOWN ("FAKE DCD"). h24serve.bat for use of a Hayes 2400-compatible modem. 3) Set up your server batch file. This is a DOS command file that you execute each time that you wish to start the server on your system. Using your favorite text editor, edit SERVE.BAT to set the proper command line parameters for SDSERVE as follows: o If you copied "hwserve.bat" above, "/w" will appear as the first parameter. Leave the "/w" intact; the following applies to the parameters FOLLOWING the "/w". o The first parameter is a number defining the server baud rate. The level 0 server operates at only one baud rate as fixed by this value. If you must have automatic baud-rate selection on each call then you might want to use Safe Deposit Level 1 with a Hayes-compatible modem. The batch file comes with the baud rate set to 1200. Change this to whatever number you wish to use. For direct connection to another PC (via a null modem) you may set any value up to 19200. CAUTION: many PC serial ports do not operate properly at rates greater than 9600. o The second parameter is the Server Name. You may make this any text string that you wish. It must be 1 to 15 characters and may not contain spaces or the special DOS characters "<", ">" and "|". The string is presented to each caller when he connects. It is for informational purposes only; no other use is made of this name. Replace the string "--INSERT-SERVER-NAME--" with your own server name. o The remaining parameters are initial command strings to be sent to your intelligent modem. For direct connections and simple modems these additional parameters should be omitted. For Hayes-compatible modems you should leave these parameters intact as they appear in the file. For non-Hayes-compatible intelligent modems you may insert strings which set your modem into the proper state. Refer June 2, 1986 11 Safe Deposit Level 0 to the owner's manual provided by the manufacturer of your modem. The strings are sent to the modem in the order that they appear on the command line with a 3-second pause after each. This operation is performed only once when the server begins execution. The modem strings may contain any characters except space and the special DOS characters "<", ">" and "|". To obtain non-enterable codes you may use the sequence "\xHH" to specify a single hexadecimal character code (where HH is replaced by a two-digit hex value from 00 to FF) or "\dNNN" to specify a single decimal character code (where NNN is replaced by a 1 to 3 digit decimal value from 0 to 255). To enter a backslash ("\") character itself you may use "\\", "\x5C" or "\d92". For example, to enter a single ASCII carriage return you could use "\d13" or \x0D". 4) Add subdirectories for the initial set of callers that you wish to have. See "ADDING NEW CALLERS" below. CHANGING COM PORTS The server will normally operate on the first serial communication port on your PC (logical COM1:). To use the second serial port (logical COM2:) execute the following DOS command at any time before you start SDSERVE: set ucom=com2 Technical description of port designation: SDSERVE is capable of operating on any serial port on your system. To use a non- standard port (i.e. something other than COM1: or COM2:) use the following command before starting SDSERVE: set ucom=xxxx:i where "xxxx" is the hexadecimal I/O address of the 8250ACE and "i" is the number of the interrupt request line on which it interrupts (0 to 7). STARTING THE SERVER Use a standard RS-232C cable to connect your PC's serial port to your modem or use a null modem to connect directly to another PC. If you are using a Hayes (300 or 1200)-compatible modem you should set the configuration switches [4] to allow the server to have optimal control over the modem. To do this set switch #1 and switch #6 UP. Other switches don't matter as long as you ____________________ [4] Refer to the owner's manual for your modem to determine the location of the configuration switches. June 2, 1986 12 Safe Deposit Level 0 have selected the proper batch file (above) and left the modem command string intact in the SERVE.BAT file. IF YOU DO NOT SET THESE TWO SWITCHES UP the server will still operate but the following happens: 1) Switch #1 being DOWN does not allow the server to cleanly disconnect a current call or to place the modem in a "known state". You may have to physically power the modem off and back on in between calls. 2) Switch #6 being DOWN does not allow the server to accurately detect the presence of an incoming call. The "/w" switch in the batch file solves this problem somewhat by causing the server to wait for a received character before assuming a call has come in. If a caller disconnects abruptly by hanging up the phone rather than selecting the "Terminate Session" menu item, the server may not realize that the connection has been broken for several minutes. In this situation other callers are prevented from accessing your system. You can power cycle the modem and/or restart SDSERVE manually to recover quickly. SDSERVE will eventually recover (after about 5 minutes). If you are using a Hayes 2400-compatible modem there are no switches. The SERVE.BAT batch file sets the modem parameters properly for SDSERVE. Start the server by entering the following commands: c: cd \safeserv serve The server operates unattended with no operator intervention from this point on. The current state of the server is displayed on the screen as well as the access code of the caller when someone is logged in. STOPPING THE SERVER You may terminate the server at any time by pressing CONTROL- BREAK. If any caller is logged in he is immediately disconnected with no explanation. Check the display before doing this to avoid cutting off an in-progress call. June 2, 1986 13 Safe Deposit Level 0 ADDING NEW CALLERS Assign an "access code" to each caller who is to make use of your server: c: cd \safeserv md accesscode md anotheraccesscode . . etc. . This code may also be thought of as a caller name or caller id. The access code takes the same format as a DOS file name (a 1 to 8 character name). Use of file name extensions should be avoided. Each access code should be kept confidential between you and the caller. The subdirectory name should be the same as the caller's access code. The caller's access is restricted to that subdirectory; all of his files go there. The caller has complete control over the files in that directory. He can place new files there, retrieve existing files and delete files. REMOVING CALLERS You can remove a caller by removing his subdirectory: c: cd \safeserv del accesscode\*.* rd accesscode Notice that this procedure involves first deleting all of the caller's files and then removing the directory. You cannot remove a directory without deleting all of the files first. CHANGING A CALLER'S ACCESS CODE You can change a caller's access code by using the following commands: c: cd \safeserv move oldaccesscode newaccesscode "move" is not a standard DOS command. It is provided on the distribution diskette as a file named "MOVE.COM". Note that you do not have to delete the caller's files to perform this operation. All of his files will be moved into the new directory by the move command. June 2, 1986 14 Safe Deposit Level 0 RUNNING ON THE DATA GENERAL/ONE SDSERVE will run on all standard IBM-PCs and compatibles. It will also run on the Data General/One even though it has incompatible communication ports. To enable SDSERVE to operate on the Data General execute the following DOS command before starting SDSERVE: set thismachine=dg1 Normal operation is on the first serial communication port bypassing any internal modem. Using the DOS command: set ucom=com2 before running SDSERVE causes operation to be on the second serial port. The DOS command: set ucom=com1:m causes SDSERVE to use the internal modem. June 2, 1986 15 Safe Deposit Level 0 Chapter -4- SDCALL Operator's Manual INTRODUCTION This chapter outlines the recommended procedures for setting-up your system and for accessing a Safe Deposit server PC and exchanging files with it. Knowledgeable DOS users may tailor this procedure to fit their own needs. Please read the overview description of Safe Deposit in Chapter 2 before proceeding. This manual assumes a casual working knowledge of DOS. WHAT IS SDCALL? SDCALL is the command that you use to start access to the Safe Deposit server on a remote system. After establishing a connection with the remote server by dialing out on your modem (or connecting via a null modem) you are able to exchange files between your own system and your private area of the remote system. Once connected to the remote system, SDCALL is operated through a very simple menu interface. This interface requires no special knowledge about communications and does not involve complicated commands. WHAT YOU NEED TO KNOW Before you can connect to a server you must know the following three things: 1) The telephone number of the server's modem. 2) The baud rate at which the server operates. 3) Your access code to the server. All three of these items can be obtained from the operator of the server. SETTING UP SDCALL ON YOUR SYSTEM SDCALL copies all files from the server to the current drive and subdirectory that was active when SDCALL was started. You may copy files to the server from the current drive and subdirectory or you may copy any file by specifying its full drive and path. The following examples assume that you are using a subdirectory named "SAFECALL" in the root directory of drive C. June 2, 1986 16 Safe Deposit Level 0 1) Create a subdirectory named "SAFECALL" in the root directory using the following commands: c: cd \ md safecall 2) Insert the Safe Deposit Level 0 distribution diskette into a floppy drive (drive A is assumed below) and use the following commands to copy the needed programs. Substitute a name for "X" in the second command depending on the type of connection and modem you will use. copy a:sdcall.exe copy a:X call.bat For "X" substitute: ncall.bat for direct connection by null modem or for use of a simple modem. icall.bat for use of a non-Hayes compatible intelligent modem. hcall.bat for use of a Hayes (300 or 1200)- compatible modem with switch #6 UP ("REAL DCD"). See the discussion of modem switch settings in the section below entitled "STARTING A SESSION". hwcall.bat for use of a Hayes (300 or 1200)- compatible modem with switch #6 DOWN ("FAKE DCD"). h24call.bat for use of a Hayes 2400-compatible modem. Now using your favorite text editor, edit CALL.BAT to set the proper command line parameters for SDCALL as follows: o If you copied "hwcall.bat" above, a "/w" will appear as the first parameter. Leave the "/w" intact; the following applies to the parameters FOLLOWING the "/w". o The first parameter is a number which defines the baud rate at which you operate. A level 0 server operates at only one baud rate as determined by the operator of the server. The batch file comes with the baud rate set to 1200. Change this to whatever number the operator of the server has instructed you to use. June 2, 1986 17 Safe Deposit Level 0 o The remaining parameters are initial command strings to be sent to your intelligent modem. For direct connections and simple modems these additional parameters are not present. For Hayes-compatible modems you should replace the string "--INSERT-PHONE-NUMBER--" with the phone number of your server's modem. Remember that the Hayes command protocol allows you to insert one or more commas (",") to cause 1 or more 2-second delays in the dialing sequence whenever it is required to wait before proceeding. For non-Hayes-compatible intelligent modems you may insert strings that will set your modem into the proper state and/or initiate a dial-out. Refer to the owner's manual provided by the manufacturer of your modem. The strings are sent to the modem in the order that they appear on the command line with a 3-second pause after each. This operation is performed only once when SDCALL begins execution. The modem strings may contain any characters except space and the special DOS characters "<", ">" and "|". To obtain non-enterable codes you may use the sequence "\xHH" to specify a single hexadecimal character code (where HH is replaced by a two-digit hex value from 00 to FF) or "\dNNN" to specify a single decimal character code (where NNN is replaced by a 1-3 digit decimal value from 0 to 255). To enter a backslash ("\") character itself you may use "\\", "\x5C" or "\d92". For example, to enter a single ASCII carriage return you could use "\d13" or \x0D". CHANGING COM PORTS The caller will normally operate on the first serial communication port on your PC (logical COM1:). To cause it to operate on the second serial port (logical COM2:) execute the following DOS command at any time before you start SDCALL: set ucom=com2 Technical description of port designation: SDCALL is capable of operating on any serial port on your system. If you wish to use a non-standard port (i.e. something other than COM1: or COM2:) then use the following command before starting SDCALL: set ucom=xxxx:i where "xxxx" is the hexadecimal I/O address of the 8250ACE and "i" is the number of the interrupt request line on which it interrupts (0 to 7). June 2, 1986 18 Safe Deposit Level 0 STARTING A SESSION Use a standard RS-232C cable to connect your PC's serial port to your modem or use a null modem to connect directly to another PC. If you are using a Hayes (300 or 1200)-compatible modem you should set the configuration switches [5] to allow SDCALL to have optimal control over the modem. To do this set switch #1 and switch #6 UP. Other switches don't matter as long as you have selected the proper batch file (above) and left the modem command string intact in the CALL.BAT file. IF YOU DO NOT SET THESE TWO SWITCHES UP the program will still operate but the following happens: 1) Switch #1 being DOWN does not allow SDCALL to cleanly disconnect a current call or to place the modem in a "known state". You may have to physically power the modem off and back on in between calls. 2) Switch #6 being DOWN does not allow the program to accurately monitor the status of a call. The "/w" switch in the batch file solves this problem somewhat by causing the program to wait for a received character before assuming a server is connected. If a server disconnects abruptly by hanging up the phone rather than waiting for caller to select the "Terminate Session" menu item, the program may not realize that the connection has been broken until the next menu item is selected. In this situation you can power cycle the modem and/or cancel SDCALL manually (Control-BREAK) to recover quickly. Start the session by entering the following commands: c: cd \safecall call If you are using a direct connection the server should be started on the other system before doing the above commands. You see the display sequence "CONNECTION ESTABLISHED", "HANDSHAKING" and the prompt "ENTER Access Code". If you are using a simple modem you see the display "WAITING FOR CONNECTION". At this time you should perform a manual dial-out operation. When contact is established with the server's modem you see the display sequence "CONNECTION ESTABLISHED", "HANDSHAKING" and the prompt "ENTER Access Code". ____________________ [5] Refer to the owner's manual for your modem to determine the location of the configuration switches. June 2, 1986 19 Safe Deposit Level 0 If you are using a Hayes-compatible modem or another intelligent modem you see the modem commands displayed as they are sent and then the display sequence "WAITING FOR CONNECTION", "CONNECTION ESTABLISHED", "HANDSHAKING", and the prompt "ENTER Access Code". After the "ENTER Access Code" prompt enter the access code that was assigned to you by the server's operator, followed by a RETURN. For security, the characters that you type are not echoed on your screens. Instead, a period is displayed for each character that you type. You may use the BACKSPACE key to correct typing mistakes. When your access code has been entered and accepted by the server the main menu is displayed: Select Next Activity <F1> List Directory <F2> Delete File(s) <F3> Send a File <F4> Get a File <F5> View a File <F6> Terminate Session OPERATING SDCALL Pressing one of the function keys F1 through F6 selects the next activity. F2 through F5 ask you to enter one line of additional information. Each of these functions is described below. <F1> List Directory This function displays a listing of the files in your private server directory on your screen. The listing format is similar to that produced by the DOS "DIR" command. Each file's name, length in bytes and last modification date and time is shown on a separate line. The listing automatically scrolls when it reaches the bottom of the screen. When complete, press any key to return to the main menu. To terminate the listing before it is complete press the ESC key. <F2> Delete File(s) Use this function to delete one or more files in your private directory on the server. When you press F2 you are asked to enter the name of the file or files to be deleted: Delete File(s) ENTER File Name June 2, 1986 20 Safe Deposit Level 0 Enter one file name (it may contain the DOS global file name characters "*" and "?") and press RETURN. To return to the main menu without deleting any files press ESC. Upon pressing RETURN, all files whose name matches the pattern that you enter are deleted. The display returns to the main menu with a message indicating the number of files that were deleted, and, if any files matching the pattern could not be deleted (because the files are marked "read only"), the number of files which could not be deleted. <F3> Send a File This function allows you to copy a file from your system to your private directory on the server. When you press F3 you are asked to enter the name of the file: Send a File ENTER File Name Enter the file name of the file on your system (it may contain a drive and path) and press RETURN. To return to the main menu without copying a file press ESC. Upon pressing RETURN, the file is copied from your system to your private directory on the server. It is given the same file name and extension but does not include the drive and path from your system. If a file by the same name already exists in your private directory on the server it is automatically replaced by the new file. As the file is being copied the display is continuously updated to show the number of bytes that have been sent. Any corrected errors (or "retries") that have occurred are also reported. When the file copy is complete, the display returns to the main menu with a message indicating the total number of bytes sent. This total will be equal to the size of the file on your system. You may cancel the operation by pressing the ESC key at any time. The partial file that was copied to the server is automatically removed. <F4> Get a File Use this function to copy a file from your private directory on the server to your system. When you press F4 you are asked to enter the name of the file: Get a File ENTER File Name Enter the file name of the file on the server (it may not contain a drive or path) and press RETURN. To return to the main menu June 2, 1986 21 Safe Deposit Level 0 without copying a file press ESC. Upon pressing RETURN, the file is copied from the server to your system. It is given the same file name in the current drive and directory on your system. If a file by the same name already exists it is automatically replaced with the new file. As the file is being copied the display is continuously updated to show the number of bytes that have been received. Any corrected errors (or "retries") that have occurred are also reported. When the file copy is complete, the display returns to the main menu with a message indicating the total number of bytes received. This total will be equal to the size of the file on the server. You may cancel the operation by pressing the ESC key at any time. The partial file that was copied from the server is automatically removed. <F5> View a File This function allows you to examine on the screen any ASCII text file in your private directory on the server. This operation is similar to the "type" command of the DOS command processor. When you press F5 you are asked to enter the name of a file to be viewed: View a File ENTER File Name Enter the file name of an ASCII text file on the server (it may not contain a drive or path) and press RETURN. To return to the main menu without viewing a file press ESC. Upon pressing RETURN, the file is sent from the server to your system and displayed on your screen. The listing automatically scrolls when it reaches the bottom of the screen. When the listing is completed, you are asked to press any key to return to the main menu. To terminate the listing before it is complete press the ESC key at any time. <F6> Terminate Session Press F6 when you are finished communicating with the server. If you are connected through a modem the phone call is terminated. SDCALL then exits and returns you to the DOS command prompt. June 2, 1986 22 Safe Deposit Level 0 RUNNING ON THE DATA GENERAL/ONE SDCALL will run on all standard IBM-PCs and compatibles. It will also run on the Data General/One even though it has incompatible communication ports. To enable SDCALL to operate on the Data General execute the following DOS command before starting SDCALL: set thismachine=dg1 Normal operation is on the first serial communication port bypassing any internal modem. Using the DOS command: set ucom=com2 before running SDCALL causes operation to be on the second serial port. The DOS command: set ucom=com1:m causes SDCALL to use the internal modem. June 2, 1986 23 Safe Deposit Level 0 Chapter -5- Level 1 Overview WHAT IS LEVEL 1? Safe Deposit Level 1 is an enhanced, full-featured version of the Safe Deposit system that is commercially available for a suggested retail price of $69.95. It provides all of the facilities available in the Safe Deposit Level 0 shareware product plus many more features, making Safe Deposit the most superb PC-to-PC file exchange system available. SAFE DEPOSIT LEVEL 1 WILL BE AVAILABLE IN SEPTEMBER OF 1986 RESERVE YOUR COPY TODAY AT A SPECIAL INTRODUCTORY PRICE OF $39.95 Send your name and address with a check for $39.95 to: The Jay Gee Programming Company 7185 Blue Hill Drive San Jose, CA 95129 SPECIAL PRICE OFFER EXPIRES SEPT. 30, 1986! Registered users of Safe Deposit Level 0 may upgrade for the price difference: $24.95 before Sept. 30, 1986, $54.95 after. Safe Deposit Level 1 is NOT COPY PROTECTED but distribution of copies is prohibited by the license agreement. Owners of a Level 1 license are permitted to distribute copies of the Level 1 caller program to their callers at no extra charge. The Level 1 server program is licensed to run on only one computer at a time and may not be copied except for backup purposes. WHAT'S IN LEVEL 1? Level 1 provides both an enhanced "server" program and an enhanced "caller" program. Both are completely BACKWARD COMPATIBLE with Level 0: The Level 1 caller can communicate with either a Level 1 server or a Level 0 server. The Level 1 server can communicate with either a Level 1 caller or a Level 0 caller. Of course, to make use of the advanced features of Level 1 both server and caller must be Level 1. Following is a brief description of each of the advanced features in Level 1 that are not available Level 0. June 2, 1986 24 Safe Deposit Level 0 Multiple Communication Line support: The server can support multiple simultaneous callers on any number of serial ports in any configuration. (Limited by server's CPU power.) Built-in Hayes Compatible Modem Support: automatic configuration and baud rate selection in server, automatic configuration and dial-out in caller. Subdirectory support: A caller may create and manipulate subdirectories (to any depth) within his private subdirectory on the server. Batch Copy Operations: Allows the caller to copy multiple files between caller and server with a single operation using a powerful wildcard syntax. Rename and Move: A caller may rename files in his private subdirectory on the server or move files between his lower- level subdirectories. Caller may also change file names as files are copied between caller and server. Passwords: The operator of a server may choose to require passwords from some or all of his callers. Super-Caller facility: The operator of a server may designate any caller to have complete access to his entire system. Super- Callers can operate on any directory on any drive and can execute arbitrary DOS commands. Enhanced List Directory function: Allows short format of directory list (similar to "dir/w") and partial listing of directories. Mail System: Allows electronic mail to be exchanged between different callers and between callers and the server operator. File Attribute Preservation: Preserves the file time and attributes when copied between server and caller. System Log: Allows server operator to review all operations that have occurred on his server. Data Compression: Simple compression of multiple-byte sequences during transmission. June 2, 1986 25 Safe Deposit Level 0